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INTRODUCTION 


OVERVIEW 


BLIS"--BASIC program LISter--prints your ATARI BASIC programs in a clear, easy-to-follow 
format. You can print each routine on a different page, if you wish. In addition, BLIS 

indents logical units like FOR-NEXT loops and IF-THEN statements. It can also print your 
REMark statements in boldface, or it can print them as titles at the top of the page, Or, 

you can specify a title to be printed at the top of each page, BLIS automatically numbers 

the pages. If your program contains multiple statements per line, BLIS will print each 
statement separately, indenting as appropriate. Other features are running top titles, 

page numbers, use of the condensed character set to preserve the visual logic even with 

long statements, and conversion of nonprinting characters within strings to printed 
representations. 


These features make debugging easier, because you can clearly see program blocks and 
subordination. These features also result in a format suitable for publication, 


To use BLIS, you save in LIST format the program you want BLIS to print, load BLIS into 
computer memory, and answer five prompted questions for setting your options. These 
include starting and ending page numbers (in case you want to print only part of your 
program listing), whether you’re using continuous paper or separate sheets, the name of 
your program file, and whether you want to print a running top title. 


REQUIRED ACCESSORIES 
i6K RAM 
ATARI 210 Disk Drive 


ATARI BASIC Language Cartridge 
ATARI $25 &0-Column Printer 


CONTACTING THE AUTHOR 
Users wishing to contact Image Marketing, Inc., about BLIS may write to the company at: 


FF. G+ Box 14 
Guymedd, FA 19434 


USING BLISS 


PRELIMINARY WORE 
Using special characters in REMark statements 


BLIS prints your pragram’s standard REMark statements in the elongated character font of 
the proportional character set. It also removes the command word "REM" to emphasize the 
text of these statements. 


You can create other effects by using three special characters at the start of your 
program’s REMark statements. These characters and their effects are as follows. 


CTRL-T Use tnis character to prevent tne 
the REM from printing im the elongated 
cnarecter set. These REMSs won’t eppear 
as Needimngs. 


CTRL-P Use this character to print the REM 
statement at the top of the mext page. 


CTRL-} + mm Use this character sequence 
(CTRL<-cown arrow, followed by &@ two-digit 
nmumoer, represented oy "mm'>) to indicate 
tne mumoer of lines to skip in the 
listing. If you don’t enter 3 mumber with 
CTRL-down arrow, ELIS skips one line. 


Storing your program file in LIST format 


To use BLIS for formatting an ATARI BASIC program, you must first store your BASIC 
program on diskette using BASIC’s LIST command, This LIST format file serves as input to 
BLIS, Thus; if you stored your file on diskette in SAVE format, LOAD the file into RAM 
and then store it back on diskette using the LIST command. If you stored your file on 
cassette, load it into RAM and store it on diskette, If it’s already resident in RAM, 
simply store it on diskette using the LIST command, For example, if your BASIC program is 
named PROG,LST, then you’ll store it on diskette via the command (we'll store it on the 
diskette in drive one)! 


LIST "DiFROG.LST" 


If you were to print this file or display it on your TY screen, it would look the same as 
if you issued the direct mode command "LIST" while the program is resident in RAM. The 
first sample listing (of part of the BLIS program) at the end of these instructions 
illustrates this normal listing format. 


RUNNING BLIS 
Getting started 


(Note, If you’re just starting a computer session, follow all these steps, If you’ve 
already been working with your system, then go to step 3 and follow the remaining steps, 
as appropriate.) 


1, Insert the ATARI BASIC Language Cartridge in the (Left Cartridge) slot of your 
computer. 


2. Turn on your disk drive(s). 


3. When the BUSY light on your disk drive goes out, open the drive door and insert the 
BLIS diskette with the label in the lower right-hand corner nearest to you, 


4, Turn on your computer and TV set, 
Sy Turn on your printer and interface module. 


6. When the READY prompt displays on your TV screen, type RUN "D‘BLIS,BAS" and press the 
RETURN key. If you’re using more than one disk drive, remember to follow the device 

initial (D) with the number of the drive containing the BLIS diskette (e.g., RUN 
"D2‘BLIS.BAS" for disk drive two), The program will load into computer memory and start, 


Setting your options 


After you load BLIS into RAM, BLIS will prompt you for all option settings. The prompts 
are as follows, 


STARTING FAGE NUMBER? 


To print less than the complete file (because of a printer jam, program change, and 

SO on, affecting only some pages), enter the beginning page number in response to 

this prompt and press the RETURN key, If you simply press the RETURN key in response 
to this prompt, BLIS will print the entire document and it will skip the next 

prompt, If you make a mistake in entering a page number, the prompt will redisplay,. 


ENDING FAGE NUMBER? 


To print a range of pages instead of printing to the end of the document, enter the 
number of the last page you want printed and press the RETURN key. If you simply 
press the RETURN key in response to this prompt, BLIS will print to the end of the 
document. If you make a mistake in entering a page number, the prompt will 
redisplay. If you type in an ending page number that is less than the starting page 
number, BLIS will sound the buzzer, display the message "ENDING PAGE LESS THAN 
STARTING PAGE", and redisplay the prompt. 


SEF ARATE SHEETS? 


To print on noncontinuous sheets, enter a "Y", "y", or other response beginning with 
the letter "Y" and press the RETURN key, BLIS will stop at the end of every page and 
remind you to insert the next sheet in the printer. To print on continuous paper, 
press the RETURN key. 


ENTER FILESPEC? 


Type the name of your program’s diskette file stored in LIST format in the form 
Ditfilename> and press the RETURN key. If you have one disk drive and haven’t yet 
inserted the diskette containing your LIST-formatted file, do so now. If you have 
more than one disk drive and the diskette containing your LIST-formatted file isn’t 
in drive one, remember to precede the device initial with the drive number (e.g. 
D2:PROG.LST for drive two). 


ENTER TITLE? 
BLIS will print at the top of every page whatever you type in response to this 
prompt (remember to press the RETURN key). If you simply press the RETURN key and 
the first line of your program is a REMark statement, BLIS uses this statement as 
the title. If you simply press the RETURN key and the first line of your program 
isn’t a REMark statement, BLIS won’t print a title. 
FOSITION FAFER 
This prompt lets you adjust the paper before BLIS starts printing, After you’ve 
positioned the paper, press the RETURN key to signal BLIS to begin. , 
BLIS displays one additional prompt if you specified separate sheets. The message 
INSERT NEXT SHEET 
displays whenever BLIS comes to the end of a page, Insert another sheet and press 
the RETURN key to signal BLIS to continue. 
During printing and end of printing 
While BLIS prints your program file, the display on your TV screen won’t change (it 
contains only the prompts and your answers), In addition, BLIS will pause frequently 


during printing to read blocks of code, 


When BLIS finishes printing your file, the READY prompt will display on your TV screen. 
If BLIS printed to the end of your file, it will print the message 


at the end of the listing. If it printed only one page or a range of pages, it won’t 
print this message, In addition, the message 


THE LISTING IS FINISHED 


displays on your TV screen after printing a partial or complete listing, along with the 
READY prompt; indicating BLIS has turned control back over to BASIC, 


The second sample listing (of part of the BLIS program) at the end of these instructions 
illustrates most of BLIS’s formatting features, 


Nonprintable character translations 


BLIS translates each nonprintable character within a string in quotation marks to a 
printable representation. The following table presents the ATASCII decimal value and 
the printed representation BLIS uses for that value (notice that the characters are 

all underlined, to distinguish them from their regular counterparts), (See Appendix 

C, "ATASCII CHARACTER SET", in the ATART 400/800 BASIC Reference Manual for a list 
of these characters.) 


CHARACTER TRANSLATION TABLE 
ATASCIT value ELIS printed representation 


000 
O01 
002 
003 
004 
005 
006 
007 


Qo 
Ke 
+ 
It IN IM EXPE ICICIA ROS OPP IOP IST ERIC THIZ OPT IMO IO Rape 


o 
rH 
oo 


ra) 
i 
oS 
je yoy 


CHARACTER TRANSLATION TABLE, coambirued 


ATASCIT velue ELIS printed representetion 


096 i, 
123 £ 
aie o 
124 te 
LZ t. 
156 os 
Ley v 
Ss S 
159 t 
253 aS 
Zod 4 
aaa a 


(Note, Most inverse video characters print the same as normal video characters.) 


SampeLte Nonkematted Predram_ Lishng 


1 REM BLIS: Basic List program —- Copyright (c) 1981 by Image Marketing Inc. 
2 REM MAINLINE 
3 


DIM HOME$(64)3FOR I=1 TO 64¢HOMES$(I,I)=" 
"SNEXT I 

pe 2 912 oe BLIS. (Version 1 +0) "SPRINT ¢ PRINT 
3S DIM TITLE$(70),LINESAVE$(132) ,XTRANS#$(12),TRANS$(44)3GOSUE 2000 
6 DIM SEQSTARTS(4),SEQEND$(2)3LET SEQSTART$="""LET SEReEnNows='" 
7 TRUE=1;3FALSE=0$ FLACE=11 2 INDENT=11?PAGE=0  INDENTHOLD=11? BKLEN=1iSHEETS=FALSEiPG 
LEN=358 
8 DIM FILE$(15),LINEINS (128) ,LINEQUT$(132),LINEID$(6),STMT$(128) ,SEQ1$(4) ,SEQ2Z3¢ 
2),P$(5) 


9 DIM BLANK$(132)°FOR X=1 TO 132¢BLANKS(X,X)="" "NEXT X 
10 REM S GET PARAMETERS 
lil PRINT "STARTING PAGE NUMBER "$SINPUT.FPSSIF P$="" THEN 16 


12 TRAP 113SP=VAL (PS) 

13 PRINT "ENDING PAGE NUMBER "$3INPUT PS3IF PS="" THEN 17 

14 TRAF 13°EFP=VAL(P$)3IF EP<SFP THEN PRINT "SENDING FAGE LESS THAN STARTING PAGE" 
;GOTO 11 

15 GOTO 25 

16 SP=13EP=100°GOTO 25 

17 EP=100¢GOTO 25 

18 FRINT "SEPERATE SHEETS" $3? INPUT PS$3IF LEN(P$)>0 THEN IF P$¢(1,1)="Y¥" OR P$(1,1) 
="y4" THEN SHEETS=TRUE?PGLEN=S0 

19 RETURN 

25 GOSUE 18iPRINT "ENTER FILESFEC"$ 3 INPUT FILES 

26 PRINT "ENTER TITLE"$2 INPUT TITLES{ PRINT "POSITION PAPER"S INPUT PS 
27 IF TITLES=""" THEN STMTIN=TRUE?GOTO 29 

28 GOSUEB 500 

29 TRAP 10 

30 OFEN #1,4,0,FILE$% 

40 TRAP 200 

45 IF STMTIN=TRUE THEN INPUT #1;3LINEINS?GOTO 70 

47 REM 5S GET NEW LINE 

30 INPUT #13LINEINS 

S1 LET XNEW=TRUE 

53 REM S GET LINE NUMBER 

60 LINENO=VAL (LINEINS ) 


70 FOR IT=1 TO LEN(LINEINS) {IF LINEINS(I,I)=" " THEN 90 

80 NEXT I 

90 LINEINS=LINEINS (I+1) 

95 IF STMTIN=TRUE AND LINEINS(1,3)%2"REM" THEN TITLES="_"3GOSUB SOO0:STMTIN=FALSE 
;GOTO SO 


96 IF STMTIN=TRUE THEN TITLES=LINEINS (4) 2STMTIN=FALSE?GOSUE S00:GOTO 50 
100 GOSUE 600 

110 LINEID$=STR$(LINENOQ) 

120 LINEOQUT$(7-LEN(LINEID$) ,6)=LINEID$iSEQ1$=""SSEQ2$="" 

130 GOSUE 300 

140 IF LINECOUNT=58 THEN GOSUB 400 

150 GOTO 50 


ELIS $ 


Basic List program —- Copyrient (c) 1981 by Image Marketing Inc FAGE 1 


2 MAINLINE 
3 DIM HOMES (44); 
FOR I=i TO 64: 
HOMES (I, T)="J"¢ 


4 PRINT "c BLIS__(Version_1.0)_ 0 "s 


5S DIM -TITLE$(70) ,LINESAVES(132) ,XTRANS$(12) , TRANS$(44)¢ 
GOSUB 2000 
& DIM SEGSTART$(4) ,SEGEND$(2): 
LET SEGSTART$="eGen"s 
LET SEDEND$="eT" 
7 ~~“ TRUE=13 
FALSE=03 
PLACE=113 
INDENT=11; 
PAGE=03 
INDENTHOLD=11: 
BKLEN=1; 
SHEETS=FALSES 
PGLEN=58 
DIM FILE$(15) ,LINEINS(128) ,LINEDUTS(132) ,LINETD$(4) ,STMT$(128) ,SED1$(4) ,SEQZ2$(2) ,P$(5) 
DIM BLANK$(132)$ 
FOR X=1 TO 1323 
BLANK$(X)X)="" "3 
NEXT X 


oo 


10 GET PARAMETERS 
11 PRINT "STARTING PAGE NUMBER ""}1 

INPUT PS: 

IF P$=""" THEN 16 
12 TRAP 11! 


IF P$="" THEN 17 
14 TRAP 133 
EP=VAL(P$) $ 
IF EP<SP THEN 
PRINT "ZENDING PAGE LESS THAN STARTING PAGE": 
GOTO 11 
15 = GOT 25 
16 9 SP=13 
EP=i00$ 
GOTO 25 
17 —- EP=100; 
GOTO 25 
18 PRINT “SEPERATE SHEETS";; 
INPUT PS; 
IF LEN(P$)>0 THEN 
TF P$(1,1)="Y" OR P$(1,1)="4" THEN 
SHEETS=TRUE} 
PGLEN=50 
19 RETURN 


25 


9 


100 
110 
120 


130 
140 


150 


GOSUB 18: 

PRINT "ENTER FILESPEC"} 3 

INPUT FILES 

PRINT "ENTER TITLE"}3 

INPUT TITLES: 

PRINT "POSITION PAPER'S 

INPUT P$ 

IF TITLE$="" THEN 
STHTIN=TRUE? 
GOTO 29 

GOSUB 500 

TRAP 10 

OPEN #1,4,0,FILES 

TRAP 200 

IF STMTIN=TRUE THEN 
INPUT #1;LINEINS: 
GOTO 70 


GET NEW LINE 


INPUT #1;LINEINS 
LET XNEW=TRUE 


GET LINE NUMBER 


LINENO=VAL (LINEINS) 
FOR I=1 TO LEN(LINEINS) +> 
IF LINEINS(T,I)="_" THEN 90 
NEXT I 
LINEINS=LINEINS (T+1) 


TF STMTIN=TRUE AND LINEINS(1,3)<"REM" THEN 


TITLES=" "3 


LINEDUT$(7-LEN(LINETD$) ,6)=LINEIDS$ 
SERI$=""5 
SEQZ$="" 
GOSUB 300 
TF LINECOUNT>SS THEN 
GOSUB 400 
GOTO 50 


LIMITED WARRANTY ON MEDIA AND HARDWARE ACCESSORIES, 


We, Atari, Tics, guarantee to you, the original retail purchaser, that the medium on 

which the APX program is recorded and any hardware accessories soid by APX are free from 
defects for thirty days from the date of purchase, Any applicable implied warranties, 
including warranties of merchantability and fitness for a particular purpose, are also 
limited to thirty days from the date of purchase, Some states don’t allow limitations on 

a warranty’s period, so this limitation might not apply to you, If you discover such a 

defect within the thirty-day period, call APX for a Return Authorization Number, and then 
return the product along with proof of purchase date to APX, We will repair or replace 

the product at our option, 


You void this warranty if the APX product! (1) has been misused or shows signs of 
excessive wear} (2) has been damaged by use with non-ATARI products} or (3) has been 
serviced or modified by anyone other than an Authorized ATARI Service Center, Incidental 
and consequential damages are not covered by this warranty or by any implied warranty. 
Some states don’t allow exclusion of incidental or consequential damages, so this 
exclusion might not apply to you. 


DISCLAIMER OF WARRANTY AND LIABILITY ON COMPUTER PROGRAMS, 


Most APX programs have been written by people not employed by Atari, Inc. The programs we 
select for APX offer something of value that we want to make available to ATARI Home 
Computer owners, To offer these programs to the widest number of people economically, we 
don’t put APX products through rigorous testing. Therefore, APX produts are sold "as is", 
and we do not guarantee them in any way. In particular, we make no warranty, express or 
implied, including warranties of merchantability and fitness for a particular purpose, We 

are not liable for any losses or damages of any kind that result from use of an APX 

product, 
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ATART PROGRAM EXCHANGE 
REVIEW FORM 


We’re interested in your experiences with APX programs and documentation, both favorable and 
unfavorable, Many software authors are willing and eager to improve their programs if they know 
what users want, And, of course, we want to know about any bugs that slipped by us, so that the 
software author can fix them. We also want to know whether our documentation is meeting your needs. 
You are our best source for suggesting improvements! Please help us by taking a moment to fill in 
this review sheet. Fold the sheet in thirds and seal it so that the address on the bottom of the 

back becomes the envelope front. Thank you for helping us! 


1. Name and APX number of program 


2, If you have problems using the program, please describe them here, 


3. What do you especiaily like about this program? 


4, What do you think the program’s weaknesses are? 


s+ How can the catalog description be more accurate and/or comprehensive? 


&, Qn ascale of 1 to 10, 1 being “poor” and 10 being "excellent", please rate the following 
aspects of this program? 


Easy to use 
User-oriented (e.g., menus, prompts, clear language) 
Enjoyable 

Self-instructive 

Useful (non-game software) 

Imaginative graphics and sound 


7. Describe any technical errors you found in the user instructions (please give page numbers), 


3. What did you especially like about the user instructions? 


9, What revisions or additions would improve these instructions? 


10, On a scale of 1 to 10, 1 representing "poor" and 10 representing “excellent”, how would you 


rate the user instructions and why? 


11, Other comments about the software or user instructions: 


ATARI Program Exchange 
Attn! Publications Dept, 
P.O, Box 50047 

60 E. Plumeria Drive 

San Jose, CA P5150 


Cseal herel 


